home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / Xm / MrmFetchSetValues.z / MrmFetchSetValues
Encoding:
Text File  |  2001-04-17  |  7.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV     MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss - Fetches the values to be set from
  10.           literals stored in UID files
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Mrm/MrmPublic.h>
  14.           CCCCaaaarrrrddddiiiinnnnaaaallll MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss(
  15.           MMMMrrrrmmmmHHHHiiiieeeerrrraaaarrrrcccchhhhyyyy hhhhiiiieeeerrrraaaarrrrcccchhhhyyyy____iiiidddd,
  16.           WWWWiiiiddddggggeeeetttt wwwwiiiiddddggggeeeetttt,
  17.           AAAArrrrggggLLLLiiiisssstttt aaaarrrrggggssss,
  18.           CCCCaaaarrrrddddiiiinnnnaaaallll nnnnuuuummmm____aaaarrrrggggssss);
  19.  
  20.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  21.           This page documents Motif 2.1.
  22.  
  23.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.           The MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessssfunction is similar to XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss,
  25.           except that the values to be set are defined by the UIL
  26.           named values that are stored in the UID hierarchy.
  27.           MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessssfetches the values to be set from literals
  28.           stored in UID files.
  29.  
  30.           _h_i_e_r_a_r_c_h_y__i_d
  31.                     Specifies the ID of the UID hierarchy that
  32.                     contains the specified literal.  The value of
  33.                     _h_i_e_r_a_r_c_h_y__i_dwas returned in a previous call to
  34.                     MMMMrrrrmmmmOOOOppppeeeennnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyPPPPeeeerrrrDDDDiiiissssppppllllaaaayyyy.
  35.  
  36.           _w_i_d_g_e_t    Specifies the widget that is modified.
  37.  
  38.           _a_r_g_s      Specifies an argument list that identifies the
  39.                     widget arguments to be modified as well as the
  40.                     index (UIL name) of the literal that defines the
  41.                     value for that argument.  The name part of each
  42.                     argument (_a_r_g_s[_n]._n_a_m_e) must begin with the string
  43.                     XXXXmmmmNNNN followed by the name that uniquely identifies
  44.                     this attribute tag.  For example, XXXXmmmmNNNNwwwwiiiiddddtttthhhhis the
  45.                     attribute name associated with the core argument
  46.                     _w_i_d_t_h.  The value part (_a_r_g_s[_n]._v_a_l_u_e) must be a
  47.                     string that gives the index (UIL name) of the
  48.                     literal.  You must define all literals in UIL as
  49.                     exported values.
  50.  
  51.           _n_u_m__a_r_g_s  Specifies the number of entries in _a_r_g_s.
  52.  
  53.           This function sets the values on a widget, evaluating the
  54.           values as public literal resource references resolvable from
  55.           a UID hierarchy.  Each literal is fetched from the
  56.           hierarchy, and its value is modified and converted as
  57.           required.  This value is then placed in the argument list
  58.           and used as the actual value for an XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeesssscall.
  59.           MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessssallows a widget to be modified after
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 4/6/01)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV     MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           creation using UID file values the same way creation values
  75.           are used in MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt.
  76.  
  77.           As in MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt, each argument whose value can be
  78.           evaluated from the UID hierarchy is set in the widget.
  79.           Values that are not found or values in which conversion
  80.           errors occur are not modified.
  81.  
  82.           Each entry in the argument list identifies an argument to be
  83.           modified in the widget.  The name part identifies the tag,
  84.           which begins with XXXXmmmmNNNN.  The value part must be a string
  85.           whose value is the index of the literal.  Thus, the
  86.           following code would modify the label resource of the widget
  87.           to have the value of the literal accessed by the index
  88.           OOOOKKKK____bbbbuuuuttttttttoooonnnn____llllaaaabbbbeeeellll in the hierarchy:
  89.  
  90.           args[n].name = XmNlabel;
  91.           args[n].value = "OK_button_label";
  92.  
  93.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  94.           This function returns one of the following status return
  95.           constants:
  96.  
  97.           MMMMrrrrmmmmSSSSUUUUCCCCCCCCEEEESSSSSSSS
  98.                     The function executed successfully.
  99.  
  100.           MMMMrrrrmmmmPPPPAAAARRRRTTTTIIIIAAAALLLL____SSSSUUUUCCCCCCCCEEEESSSSSSSS
  101.                     At least one literal was successfully fetched.
  102.  
  103.           MMMMrrrrmmmmBBBBAAAADDDD____HHHHIIIIEEEERRRRAAAARRRRCCCCHHHHYYYY
  104.                     The hierarchy ID was invalid.
  105.  
  106.           MMMMrrrrmmmmFFFFAAAAIIIILLLLUUUURRRREEEE
  107.                     The function failed.
  108.  
  109.      RRRREEEELLLLAAAATTTTEEEEDDDD
  110.           MMMMrrrrmmmmOOOOppppeeeennnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyPPPPeeeerrrrDDDDiiiissssppppllllaaaayyyy(3), XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss(3).
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 4/6/01)
  130.  
  131.  
  132.  
  133.